#!/usr/bin/python
# -*- coding: UTF-8 -*-
"""
函数定义：
    语法:
        def fun_name(param1, param2, ... paramn):
    函数默认值的参数:
        默认值只会执行一次，这条规则在默认值为可变对象(列表、字典以及大多数类实例)时很重要。
    关键字参数:
        可以使用形如 kwarg=value 的关键字参数来调用函数。
    任意的参数列表:

    解析包参数列表:
"""

"""
默认值函数:
    retries、reminder 都提供了默认值，所以调用的时候不是必传参数
调用方式：
    1. 只给出必传参数: ask_ok('Do you really want to quit?')
    2. 给出一个可选参数: ask_ok('OK to overwrite the file?', 2)
    3. 给出所有参数: ask_ok('OK to overwrite the file?', 2, 'Come on, only yes or no!')
"""


def ask_ok(prompt, retries=4, reminder='Please try again~'):
    while True:
        ok = input(prompt)
        if ok in ('y', 'ye', 'yes'):
            return True
        if ok in ('n', 'no', 'nop', 'nope'):
            return False
        retries = retries - 1
        if retries < 0:
            raise ValueError('invalid user response')
        print(reminder)


# print(ask_ok('Do you really want to quit?'))


"""
可变参数时，这种方式会在可变参数中追加参数值，若不想要在后续调用之间共享默认值，可以写成 f1 的形式
"""


def f(a, L=[]):
    L.append(a)
    return L


print(f(1))
print(f(2))
print(f(3))


def f1(a, L=None):
    if L is None:
        L = []
    L.append(a)
    return L


print(f1(1))
print(f1(2))
print(f1(3))

"""
关键字参数:
    可以使用 kwarg=value 的关键字参数来调用函数;
    关键在参数必须跟随在未知参数的后面；
    传递的所有关键字参数必须与函数接收的其中一个参数匹配；
    关键字参数可以不按照函数参数的顺序；
    不能对同一个参数多次复制
"""


def parrot(voltage, state='a stiff', action='voom', type='Norwegian Blue'):
    # print("-- This parrot wouldn't", action, end=' ')
    print("if you put", voltage, "volts through it.")
    print("-- Lovely plumage, the", type)
    print("-- It's", state, "!")


parrot(1000)  # 1 positional argument
parrot(voltage=1000)  # 1 keyword argument
parrot(voltage=1000000, action='VOOOOOM')  # 2 keyword arguments
parrot(action='VOOOOOM', voltage=1000000)  # 2 keyword arguments
parrot('a million', 'bereft of life', 'jump')  # 3 positional arguments
parrot('a thousand', state='pushing up the daisies')  # 1 positional, 1 keyword


def cheeseshop(kind, *arguments, **keywords):
    print("-- Do you have any", kind, "?")
    print("-- I'm sorry, we're all out of", kind)
    for arg in arguments:
        print(arg)
    print("-" * 40)
    for kw in keywords:
        print(kw, ":", keywords[kw])


cheeseshop("Limburger", "It's very runny, sir.",
           "It's really very, VERY runny, sir.",
           shopkeeper="Michael Palin",
           client="John Cleese",
           sketch="Cheese Shop Sketch")

"""
任意的参数列表:
    最不常用；
    参数被包含在一个元组里；
    在可变数量参数之前，可能会出现零个或多个普通参数；
    一般来说，这些可变参数将在形式参数列表的末尾；
"""


def concat(*args, sep="/"):
    return sep.join(args)


print(concat("earth", "mars", "venus"))
print(concat("earth", "mars", "venus", sep="."))
print(concat("yang", "de", "jun", "Good", "Man", sep=" "))

"""
解析包参数列表:
    使用 * 运算符编写函数调用以从列表或元组中解析包参数
"""
print(list(range(3, 6)))
args = [3, 6]
print(list(range(*args)))


def parrot(voltage, state='a stiff', action='voom'):
    print("-- This parrot wouldn't", action, end=' ')
    print("if you put", voltage, "volts through it.", end=' ')
    print("E is", state, "!")


d = {"voltage": "four million", "state": "bleedin' demised", "action": "VOOM"}
parrot(**d)
